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g the gameon the Pi! 


Minecraft is 3 popular 
sandbox open-world building 
game. A free version a 
Minecrait is available for the “= 
ty Pi it also comes ola ° 
a geese At deen interface oh nt tome 
This means you can write fete Chat window, fg S27thOn APA pst er 
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Features 


Getting Started 
We help you set up your Raspberry Pi 
and install the software you will need 


Scratch: Learn the Basics 
Use Scratch’s drag-and-drop coding 
interface to bring your Pi to life 


Scratch: Physical Computing 
Taking Scratch to the next level, we 
show you how to work with pins 


Scratch: The Santa Detector 
Set up a trap to catch old St Nick on 
Christmas Eve, with help from Pi 


Coding with Minecraft 
Your Raspberry Pi can be used to 
code direct to the game — great fun 


Babbage versus Bugs 
Code our exciting Space Invaders clone 
written in Python with Pygame Zero. 


Pi Personality Test 
Test your thoughts on Raspberry PI 
and find out what type you are! 


Comic Capers 
The Pioneers of Pi come together to 
save the kids from Doctor Bluescreen 


Puzzles) 


we Python: Turtley Amazing 
First steps into Python coding with 


the ever-popular Turtle commands 


Python: WhooPi Cushion 
We show you how to make and code a 
farting cushion with your P!! 
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Feature 


There's a In this beginners’ feature we will 
Gota Raspberry Pv inate ean show you... 
orc 
erful wor | 

ser for you. Let's get started by @ How to select the right equipment for 
waiting fo your Pi adventure 

making sure yor ® How to connect everything together 
and accessories you correctly before you start 

showing you how to p ® How to download and set up the 

We will soon software you will need 


up and running... 


yo 
| \ in each in 
’ We're going to explain ea 
: Metall but here are the bits and 
pieces of tech you need... 


| @ Raspberry Pl 
@ Monitor or TV 
i @ HDMI cable 
@ USB keyboard 
® USB mouse 
1 @ Power supply 
@ microSD card 
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Getting Started 


A: The Raspberry P! 


The Raspberry Pi 3 is the third version 
of Raspberry Pi. It replaced the 
Raspberry Pi 2 Model B in February 
2016. New features include... 


@ A 1.2GHz 64-bit quad-core 
ARMv8s CPU 

@ 802.11n Wireless LAN 

@ Bluetooth 4.1 

@ Bluetooth Low Energy (BLE) 


Like the Pi 2, it also has... 

@ 4 USB ports 

@ 40 GPIO pins 

@ Full HDMI port 

@ Ethernet port 

@ Combined 3.5 mm audio jack 

and composite video 

® Camera interface (CSI) 

® Display interface (DSI) 

@ microSD card slot (now push-pull 
a rather than push-push) 

@ VideoCore IV 3D graphics core 


The Raspberry Pi 3 looks the same as 
the previous Pi 2 (and Pi 1 Model B+) 
and has complete compatibility with 


—— Raspberry Pi 1 and 2. 
& ) ‘mal > i a) Ea vieraspbenyer:~ ——— 
@ ah ng 4 
= 
Monitor or TV/i-oen 
yy Sy) A monitor or TV with HDMI in 


can be used as a display wij 

a Raspberry Pi. This is the mn 
quickest and easiest way to see 
what your Pi is thinking. How big 
a screen you want is up to you! 


ur Raspberry Pitoam 


Connect yo 
° : t'll give you great- 


an HDMI cable. | 


A , 

: ee IS used to move 

iceunee or Mouse pointer 

eee € screen. It’s called a 

nia as It looks like it has a 
Like the keyboard, it will be 


automatically re 
Piwhen pluggedin. © te 


6- Power Supply 


If you're using a Raspberry Pi 3, then it’s reco 
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quality pictures. 


don't nee 

lay keyb 
ditional driver. Simply plug one 
into the Raspberry Pian 
recognised W 


5 V, 2.5 A power supply. Earlier models can be powered using a current 

as low as 1.2 A. Ideally, you want to use a power supply which you know 
to be safe and which provides enough power to the Pi. You can buy 

the official Raspberry Pi power supply, or you can use a 5 V micro USB 
charger, the kind used by many mobile devices. You do need to check that 
your power supply provides the right voltage and current (5 V / 1.2-2.5 A). 


da special one. Plug-and- 
oards will work without any 


dit should be 
hen it starts Up- 


mmended that you use a 


Getting Started 
microSD Card 


You will need to in 

your PI So It cee at ; 
Raspbian, the default op 
for the Raspberry Pi, ne 
card. Not all SD cards a 
more than others. 
the official Pi SD c 


perating system ont 
O 

to do. The latest version of 
perating system recommended 
: repens (or mager) microSD 
, »and some ca i 
_ by unsure, you can ue ho 

- Any 8GB SD card will work. , 


1. Begin by placing your microSD card into the SD card slot on the 
Raspberry Pi. It will only fit one way, so you can’t get it wrong. 

2. Next, plug your keyboard and mouse into the USB ports on the 
Raspberry Pi. They will be automatically recognised. 

3. Make sure that your monitor or TV is turned on, and that you have 
selected the right input (e.g. HDMI 1, HDMI 2, etc). 

4. Connect your HDMI cable from your Raspberry Pi to your monitor or TV. 

5. if you intend to connect your Raspberry Pj to the internet, plug an 
Ethernet cable into the Ethernet port, or connect a WiFi dongle to one of 
the USB ports (unless you have a Raspberry PI 3, which doesn’t need it). 

6. When you're happy that you have plugged all the cables and SD card in 
correctly, connect the micro USB power supply. This action will turn on 

and boot your Raspberry Pi. 
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9. Connecting to the Internet 


You will probably want to connect your Raspberry Pi to your 
local network or the internet. You can use any of the following 


options to do this... 


® Connecting via Ethernet 

The Raspberry PI has an Ethernet port, alongside the USB 
ports. If your pj is situated close to a router, access point, or 
switch, you can connect to a network using an Ethernet cable. 


e Ethernet cable into the Raspberry Pl 


Once youve plugged th 
Raspberry PI will 


and the other end into an access point, your 
automatically connect to the network. 


® Connecting via WIFI gs 
If you have a Raspberry PI 3, it has built-in wireless LAN. If | 
youre using an earlier version of the Raspberry Pl, then you | 
will need a USB WiFi dongle. Some WiFi dongles, when used 

with the Raspberry Pi, are simple plug-and-play devices. 
Others require specific drivers, and may not be compatible 
with the Raspberry pi. Make sure you read the device 
manufacturer's documentation before buying one. 4 


Adding Audio Output 


What's the point i 
ne point in your Raspb 
great noises if you can't “pes sally making lots of 


ae mm audio port 
aspberry Pi comes wi 
most speakers or h es with a 3.5 mm audio port. This wi 
fantastic eadphones into the Pi port. This will allow yo 
programs like Sonic Pi i so that you you to plug 
Pi. can listen to the ou 
tput from 


® Bluetooth speakers 


With either the 
Raspberry Pi 
speakers or head yi 13 Ora Bluetooth 
phones. Your suc ongle, you can 
cess rate may var connect to Bluet 
y depending on th am 
e dongle 


and/or speaker 

Kers youre usin 

documentation before you oe Ne Se eee A 
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Getting Started 


You might find that the 8GB SD card you're using 
with your Raspberry Pi just isn't big enough for your 
needs. There are several options for increasing the 
Storage capacity of your Raspberry Pi... 


@ A bigger SD card 


microSD cards come ina variety of sizes. The largest 
(reasonably priced) microSD cards are 128GB, which 
will provide you with lots of storage. As always, check 
the manufacturer's documentation to ensure that the 
card is compatible with a Raspberry Pi. 


© USB flash drives 


There are lots of different types of storage device 
which you can plug directly into your Raspberry Pi’s 
USB ports. USB flash drives come in a variety of 
styles and sizes, and can offer up to 1TB of space if 
you need that much. 


® External hard drives 


You can also purchase external hard drives 

which can be connected via a USB cable. 

You have to be a little careful here. Some 

external hard drives are independently 

powered, and will work without problems. Some 
draw their power via the USB port, and might need 
more current that the Raspberry Pi can supply. Read 
the manufacturer's documentation to ensure any hard drive 
youre using will work with the Raspberry Pi. Some external 
hard drives have been designed Specifically to work with the 
Raspberry Pi, such as the WD PiDrive 314GB. 
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«installing Raspbian on your SD Card 
with NOOBS 


SO you've just got hold of your first cmon ce 
Raspberry Pi and you need to get the civ bianca : 

software up and running? Let's show you = 

how to install Raspbian on your Raspberry Pi — 
in no time at all... — 


® Downloading NOOBS 


Using NOOBS is the easiest way to install 
Raspbian on your SD card. To get hold of a 
copy of NOOBS... 


1. Visit www.raspberrypi.org and click on the 
Downloads button in the navigation bar, at the top of the screen. 
2. You should see a box which contains a link to the NOOBS files. Click on the link. 
. The simplest option is to download the zip archive of the files. 


® Writing NOOBS to an SD Card 


Visit etcher.io and download and install the Etcher SD card image utility. 

Run Etcher and select the Raspbian zip file you downloaded. Select the SD card 
drive — Etcher will usually do this for you. Finally, click Burn to transfer NOOBS to 
the SD card. Once complete, the utility will eject/unmount the SD card so it’s safe 
to remove it from the computer. 


® Booting from NOOBS 


1. Once the files have been copied 
over, insert the microSD card into nal 
your Raspberry Pi and then plug it | ——— ; ] 
into a power source. | Ie hoe : | 

2. You will be provided with a single corer isn ee 
option, once the installer has CS san empty 5128 ext forma parton tothe patton 
loaded. You should check the box for 
Raspbian, and then click Install. 

3. Click Yes at the warning dialog, and 
then sit back and relax. It will take a " 
while, but Raspbian will install. i 


| | Needed: 3662 MB 
| | Available: 6508 MB 


+, Keyboard (9): |gb \¥ 


ey 


Language (1) “13 English (UK) 
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Everyone wants a piece of Raspberry Pi! Here are fiv 


e characters from the world 
of Pi. All of them want to plug in and 


create a Cool project, but which one is 


connected? Trace the cables to find out! 


| requires Scratch 2. 


To use It, — 
i 
Pi2or3 runnt 7 
Raspbian ope 
eae USB keyboar 


ting system, plus 2 


Tick off each 
step as you go! 


+ |v 


@ 


By following the steps in this 
feature, you will learn... 


What all the buttons and toolbars in the 
Scratch window do 


How to use blocks to make the Scratch 
cat move about 
How to change sprites 


How to create your own sprites 


HEE-HEE/ 
| CAN’T WAIT 
TO GET STARTED 
IN SCRATCH! 


A 
" Open up Scratch 


You'll find Scratch 2 in Menu > Programming. Once 
opened, you will see a window like this... 


Bae |OCS CFilev Edity Zt 3o 3 


eu FR 


1. Stage 2. Blocks palette 
3. Scripts area 4. Sprite list 


2 Make the Scratch cat move 


The cat on the white background Is an example of a sprite in Scratch. 
Currently the Scratch cat sprite is ona blank stage. First, let's get the 


cat to move. 


1_ Click on the Scratch cat sprite. 


2. Then click on the blocks palette and select Events. 


Scratch Coding 


the 
3. Next, drag a when green flag clicked block and place It on 
) scripts area on the right of the screen. 


ks palette and 
from the Motion bloc 
move 10 steps block fror | 
7 mae to the when green flag clicked block 


the cat move! 


6. How would you get the Scratch cat to 
move further? 


All sprites in Scratch can wear different costumes. 


T. Click on your sprite to select it. In the Scripts area in the middle of 
the screen, click on the Costumes tab. 


2. You will see that the cat has two costumes. Right-click costume 2 
and select duplicate to make a third costume. 

3. Select costume3 and it will appear in the Paint Editor. Experiment 
with all the buttons and tools to find out what they do. 


4. Next, draw some clothes on the costume and click OK. 


2. To switch between costumes, click on the Scripts tag. Add the 


purple Looks block, switch to costume, to the other blocks and 
connect it. 


6. Select costume? from the 
drop-down menu on the 
purple block. 


/. Now run your program to see 
the costume change. 


Learn the Basics 


By» Add sprites 


If you feel that the Scratch cat sprite does not suit your needs then you 
can add other sprites, or even create your own! 


1. At the top of the Sprites palette are four icons to create a new sprite. 


2. The first allows you to Choose sprite from library. This opens a 
window where you can choose one of Scratch’s built-in sprites. 


2. The second icon, Paint new sprite, opens the Paint Editor. Here you 
can use shapes, lines, and freehand drawings to make your own 
custom characters. Have fun! 


4. The third icon lets you Upload sprite from file, to use an existing 
image or Scratch sprite. 


. Sprit — “ 
5. The fourth icon enables you chs New sprite: & / ta] iG 


to create a New sprite from 
camera (if one is connected). 


es 


Sprite 


-) 


SCRATCH IS 
A GREAT 
_ INTRODUCTION Now esto 
you know the basics 0 
TO CODING! | Scratch, there are lots of great 
| projects you can have a go at... 


~~ «A 


Try completing the Robot Antenna 
Resource to make an LED blink! 
Create a button using candy sweets 
with the Sweet Shop Reaction Game. 


These and more can be found on the 
Raspberry Pi Learning Resources 
website at... 


Scratch Coding 


By completing this project 
you will learn... 


How to control the GPIO pins 


using Scratch 
How to receive input from the 


GPIO pins using Scratch 


Note 


Visit the Raspberry Pj 
Website for latest Stockist 
Information for the extra 
kit you will need to do this 
Scratch Project. 


pay What you might need 


_ As well as a Raspberry Pi with an 


7 SD card and the usual peripherals, MALE-TO-FEMALE 
you'll also need... JUMPER CABLE 


tag ; 


a ae a ee 

‘a 

led 772 
- 


TACTILE PUSH 


BUTTON 
Peeverery 
BREADBOARD 
PIR SENSOR ssn : K 


LED 


» 


‘\ — “(PIEZO BUZZER 
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A. GPIO pins 


One powerful feature of the Raspberry Pi 

is the row of GPIO pins along the top edge 
of the board. GPIO stands for General- 
Purpose Input/Output. These pins area 
physical interface between the Raspberry Pi 
and the outside world. At the simplest level, 
you can think of them as switches that you 
can turn on or off (input) or that the Pi can 
turn on or off (output). 


The GPIO pins allow 

the Raspberry Pi to 
control and monitor the 
outside world by being 
connected to electronic 
circuits. The Pi is able 
to control LEDs, turning 
them on or off, run 
motors, and many other 
things. It’s also able to 
detect whether a Switch 
has been pressed, the 
temperature, and light. 7 | 
We refer to this as Z : P88 pra ms 
physical computing. 


Pi2 A+ B+ GPIO 


There are 40 pins on the Raspberry Pi (26 pins on 
early models), and they provide various different functions. 


If you have a RasPio pin label, it can help to identify what each pin is 
used for. Make sure your pin label is placed with the keyring hole facing 
the USB ports, pointed outwards. 
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If you don't have a pin label, then this guide can help you to identify the 


pin numbers... 


You'll see pins labelled as 3V3, SV, GND and GP2, GP3, etc... 


3V3 3.3 volts 

5V 5 volts 

GND ground 
GP2... GPIO pin 2... 


ID_SC/ID_SD/DNC Special 
purpose pins 


»* 000 6° @200e@ 2 e090 
@0c200 02928280000 @e0o0000 


Raspberry Pi A+ / B+ and Raspberry Pi 2/3 pinn 


@ GPIO Eo Ground & 3.3v € 5v Advanced use only py 


umbers 
iD EEPROM 


Anything connected to these pins 
will always get 3.3 V of power 


Anything connected to these pins 
will always get 5 V of power 


Zero volts, used to complete a 
circuit 
These pins are for general-purpose 


use and can be configured as input 
or output pins 


Don't use these ones 


Mone’ @ 


A 


—_ 


Physical Computing 


2: Lighting an LED 


You can test whether your GP] 


O pins and LEDs are workin 
circuit below. You can use any 


g by building the 
resistor over about 500. 


1. The LED is connected directly to the GND pin, and the 3V3 pin via the 
resistor, and should light up. 


2. Be sure to 
connect your 


LED the correct 

Way round; 

the longer ava] sv 
leg should be 


BI 


G 
wv 
uu 


connected to 
the 3V3 pin... 


_—  —_ 


Ss 
Win 
5/8 


, Gyicy 
Viv 
~ iS 
TW 

; 2 a 
co nw 

yi 


5 Using a switchable pin 


1. To control the 
LED, you'll need 
to adapt your 
circuit to use a 
switchable pin. 


AB 
~~ 
n) |W 
Gy 

wi tui 
> 


oO 
7S 
iW 


2. In the diagram 


oq) 
> 
> 


here, pin 17 has 
GP17{GP) 
been used, but cut 
you can use any 
1 3V3 |GP24 i 
numbered pin — ' 


you wish. 


| 
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A. Constructing a 
Scratch program 


1. Locate the Scratch program by 
clicking on Menu followed by 
Programming, and selecting 
Scratch 2. 


2. The familiar 
Scratch 
interface will 
then load... 


3 age peemer oe Teg 


3. Click on 
Events 
from the 
blocks 
palette. 
Drag the 
when green flag clicked block 

onto the scripts area... 


4. To add GPIO functionality, first 
click More Blocks and then Add 
an Extension. You should then 
select the Pi GPIO extension 
option and click OK. 


Extension Library 


Category 
All 
Haraware 
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5. In the More Blocks section, 
youll now see two additional 
blocks for controlling and 
responding to your Pi GPIO 
pins. You can change the pin 
number by selecting the round 
field and typing it in. 


Make a Block 
Add an Extension 


Pi GPIO ¥ © 


set gpio & to output high 
gpic @ is high? 


6. With set gpio 17 to output 
high or low, you can turn on 
your LED attached to GPIO 
pin 17 on or off. Using two of 
these inside a forever block, 
with wait blocks to add a 
delay, you can make the LED 
flash continuously... 


when clicked 
forever 
set gpio GRP to output high 
* - 


wait @} secs 


, 

set gpio @¥P to output low 
» 

wait & secs 
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5. 
Connecting a button 


| 


2. Connect your 


button to a 
6 eeeee 
breadboard, then wma??? * 
connect one pin 9s © pened he pe 
to a ground pin . — cee 
and the other sb ohne sede oat 
to a numbered vena eo hy ha 
GPIO pin. In this deat Bearers 
eeee¢e eeeee 
a eeees eeeee 
een used... eecee¢e ee0eees 
eececee e@e¢ 
eeee?e © 
ee¢eee e 
$ eeeees k& 


cSh | ae 


6- Configuring your button | 


1. Before Scratch can react 
to your button, it needs 
to be told which GPIO pin 
is configured as an input 


pin. 


2. If you have added the PI 
GPIO extension (step 4, 

page 22), clicking 

More Blocks will show a 

couple of blocks related 

to the Pi’s GPIO pins. 


3. In a new Scratch project 
file (File > New), select 
Events from the blocks 
palette and add a when 
green flag clicked to the 
scripts area. 


4. Select More Blocks, then 
drag a set gpio to block 
under the green flag one. 


Make a Block 
Add an Extension when clicked 
| Pi GPIO¥ @ set gpio @to output high 
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Alter the block's number 


field to 2 — to set i 
GPIO 2 for your hive Now that your button is all set up 
— and use its drop-down and working, you can make it do 
menu to set it to an something. You can start off by 
" making it control a sprite. 
fa Begin with a loop with an 
: block inside it. This will 
set gpio @ to output hi ; aoe 
Os - =~ : continually check the if condition 
Fie oo and perform some action if the 
aa od condition is met or not. In this case 
— showing one of two messages. 


Clicking the green flag 
will now set GPIO pin 2 Pa 


to an input, so we will be 
able to sense whether the 


button is being pressed. 


Pressing the button right 
now wont do anything, 
but we can create a 
fairly simple program to 
respond to a button press 
o trigger 
gger something... Now you need to add the condition, 
which requires a 
block to be placed in the 
block’s field. Note that as the pin Is 
set by default, and the button 
pulls it low, we put the 
block under 


ba 


ome 


one 


gpio @ is high? 


\ 
EM onc 


AG 


say 


lf everything is correct, your button 
should make the sprite say ‘Hello. 


1. Adapt your script by replaci 
set gpio 17 to output low 


when pa clicked 


] 


r ; 

/set gpio @ to input 
se 
forever 


r 
. 
- * 
: g 
: DIO 
7. 
. 
‘, 
> 
——EEEE 


set gpio to output lo 


There are lots of other things you 
can control or monitor with your 
Raspberry Pi. Have a look at the 
worksheets on the website to see 
how easily this can be done... 


® Using an active buzzer 
® Making traffic lights 
® Using a PIR sensor 


These and more can be 
found on the Raspberry 
Pi Learning | 
Resources website 
at... 
www.raspberrypi.org 


Controlling an LED with 
a button push 


set gpio GRD to output low | 


Ww 
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a 
& Tick off each 
step as you go! 


- [4 os 
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No more propping 
your eyes open with 
matchsticks to try to 
catch Santa‘ This Scratch 
program uses a low-cost, 
infrared detector to set 
off an alarm when Santa 
sneaks into your room. 
It’s a great introduction 
to using simple sensors 
on the Raspberry Pi, and 
can be adapted to lots of 
different projects. 
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A: -Gonnect the PIR motion sensor 


Before booting, connect the to the 
Using three female-to-female , you will need to 
connect each of the 's connectors to the appropriate 
pins on the Raspberry Pi. 
Connect the top one labelled on the PIR sensor to the 

on the Raspberry Pi, connect the middle one labelled to 
the pin, and connect the bottom one labelled toa 

also marked _ All shown in the following diagram... 


atttteenenns 


om 7 
&* Done é 
tat 
4 m\ 


Scratch uses the blocks to 
check if there is any input on the 
GPIO pins. If there is an input, the 
value of the pin changes from 
_ As you connected the 
On the desktop run Scratch using... ye af the pin of the Pi, 
we need to monitor that. 


Because we are usi ; 
ng the GPIO pins 
need to start the GPIO server in shi 


Once Scratch is running choose.. 


from th Firstly we need to tell Scratch that 
nn will be used as an input by 
Pe configuring it. 
File [ail Share Help 


Create a broadcast message 
as follows... 


== Undelete 
f|_ Start Single Stepping 
Set Single Stepping _ 
©) _ compress Sounds... 

{| ¢Compress Images... | 9) 
| Show Motor Blocks 
Start GPIO server 


Scratch Project 
Note 


If you do not see 


on the list 
the , Make sure that 


and that you have ry 


Double-click the | block to run 
it. You only need to do this once. 


In the block palette, click on 
the drop-down menu on the . 
block and choose 


Test 

spin sor by waving your 

ns In front of it. When it detects 
ovement, the value on the screen 


» Tick the checkbox to the left of the 
should change from 0 to 


block to display the pin value on screen. 


: ae value doesn't change, check 
at the correct pins are connected. 


tab and draw 


pve une This will be displayed 


distance __ 


gpio4 


ae the PIR senses movement. 

Click on the tab ae — a 
older. 

sound from the se 


have used a siren called 


we have a sensor that reports 
or off, we can use this value 


flow of our program. 


| show 
Set size to 150) 9% 
10.25) 


Now that 
when it Is on 
to control the 


Build the following script... 


What is the the program doing? 


value. 


The if statement continuously checks the 
When this changes to 1, it does the following... 


Shows the sprite 

Makes the sprite bigger 
Waits a bit 

Plays a sound 

Makes the sprite normal size 


It keeps doing this as long as 
the sensor value is 1, 1.e. when 
the PIR detects movement. 


The statement simply 
hides the sprite when the 
sensor value Is 


‘Set up the detector 
wig in your bedroom! Disclaimer! 


W 
€ Cannot guarantee that 


On 
set up your Dj this alarm will not 
. : . Scare 
with the sensor pointing at your Santa off so that yo 
edroom door a wrinkled eo not even 
nkled satsuma in an 


old sock! Sorr 
; y abo 
Connect your Pi to a anne 


Make sure the sensor does not 
detect you in bed or you will get 

: the alarm will go of 
every time you move! “= 


® 
Go to : 
® 
up when Santa comes in and a 

feed him mince pies and sherry! 
® 
qm 7 e 


Done 


s 
ois 


e Difference 


the Raspberry Pi? 


Timed Challenge: 


e look at these two Raspber 
12 differences between them. You have 5 minutes to mark all of the 


differences you can find on picture 2. When you have all 12, write your 
time in the box below — the solution Is on page 78! 


Take a clos ry Pis... there are 


SURRCRRRRRR ERE 
Serf ‘ ; ea bn ," )' 
. ‘@ ) = ¥p ~ | \ “ 
: Pi, 4 . 1 1) \ 
ies Mi ZY gaat Use er] 
Df —, 
OJ gravt 
Le, (fe t se 
G4 ee 
/ J 


= 
ssa gs 8s 8 8B 8B 8B 8 8 ®@ 
s 8 
= ss 
et iY ee ana 8s s ss Ss s 
—_ ~ 


oe 
— 
¥ 


, sa wp wp 8s @B @ 8B 8 @ @ 
~ - t, - a 
: f - a 8 


= === 
a ba 


How quickly did you 
manage to solve the 


yi 
A 


puzzle? Write in your 
time below... 


— 
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them all. Go! 


Memory 


Hs VHQ Dp 
appt wunn 'd 
AOCQAQAANRARHABDBOOANN'D = 


Algorithm Minecraft 
AstroPi Network 
Computing Program 
Gaming Python 

GPIO Raspberry Pi 


Timed Challenge: 


There are 17 words in this giant 
Raspberry. You have 10 minutes to find 


HH mOMK SaeGwx Hew AP QOGE SB 
CGuegryehMOCtPOoODeawDK KOH 
de WM Bd f2mHzZQ0OmMMmEOH 


Scratch 
SD Card 
Sensors 
USB 
WiF1 


Find allthe words inthe ra 
Sp 


K L 
DGH 
NG I 
ZPO 
YW I 
T QP 
OR HA 
UMQ 
PLE 
LIT 
I RO 
PE B 
F MO 
VHRR 
T PN 
AE T 
SG X 
NI 


Ss W M 

CK J 

RS R 

AD K 

T C 

CA 

H R F 

GDF Q 

HWDSB 

M2ZxXR 

GLAS 

N E R L 

PO JW 

»s DF : 

Se png Result: 
How quickly did you . 

T A Dural Solve the 


Ite in your 


time below 


ular 
tie d building 


By following this Project with your Raspberry Pi 
. es you will learn... 
Minecraft 1s 


)) 


@ How to access Minecraft Pi and create a new world 
IDLE to connect 
- a interface: 
ming 1n 
: rogram 
with a p 


ython Programming environment 
to Minecraft Pj 
@ How to use the Minecraft P 


ite 
This means you can WIl 


ython API to post text 
to the chat window, find the player's coordinates, 
teleport and build structures 
: : | ® How to use variables to Store IDs for different types 
n | 
scriptsin of blocks 
nds and sci in 
siaieee ode to bu Id things | @ Experimenting with placing different types of blocks 
python y automatically. Its a with special attributes 
ame l 
paste way to learn python E. 
re ° 
g SS an YOU CAN 
CONTROL 
MINECRAFT FROM 
| YOUR PI! 


You'll need a Ras 
hich includes _ 
\ oe, cya are ee - la 
: ple you can download ‘ ie = 
aomecraftnet/en-us/edition p 


Tick off each . 
stepas yougo! | 


>, i os 
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To run Minecraft Pi, open it from the 
desktop menu, in Games, or type 
minecraft-pi in the Terminal. 


S) ( ba a) |S Pi@raspbenypi: ~ 
@ Programming > . 


ya Office R 


‘229 Internet 


X > 

all rp =. ai ae 

esi eS 3} > |Minecraft Pi | 
e Graphics > 

[EP sound & Video 


‘OF System Tools > 
gD Help , 
Preferences a 
ZY Run... 
¢’) Shutdown 


[rc 


When Minecraft Pi has loaded, 
click on Start Game, followed by 
Create new. You'll notice that the 
containing window is offset slightly. 
This means to drag the window 
around, you have to grab the title 
bar behind the Minecraft window. 


You are now in a game of 
Minecraft! Go walk around, 
hack things and build things! 


Action 


USE THE MOUSE TO LOOK 
AROUND AND USE THE FOLLOWING 
KEYS ON THE KEYBOARD 


W «Forward 


A Left 


You can select an item from the quick draw panel 7 
with the mouse scroll wheel (or use the numbers on S 


: Backward 
your keyboard), or press E and select something from 
the inventory. , 
D Right 
FE __siInventory 


SPACE Jump 


Double 
space Fly/Fall 


ESC Pause/ 
Game menu 


Release mouse 
cursor 


n also double-tap 
br SPACE bar to fly into 
the air. You'll stop flying 
when you release the 
SPACE bar, and if you . 

double-tap it again you 
fall back to the ground. 


ith the sword in your 
a you can click on 
blocks in front of you 
to remove them (or to 
dig). With a block in your 
hand, you can use aed 
click to place that bloc 
in front of you, OF left , 
click to remove a block. 


\al 7 


Done 
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2: Use the Python 


programming 
interface 


With Minecraft running, and the world 
created, bring your focus away from the 
game by pressing the TAB key, which will 
free your mouse. Open Python 3 (IDLE) 
from the Programming menu and move the 
windows so they are side-by-side. 


You can either type commands directly into 
the Python window or create a file so you can 
Save your code and run it again another time. 


If you want create a file, go to File > New 
window and File > Save. You'll probably 
want to save this in your home folder ora 
new project folder. 


Start by importing the Minecraft library, 
creating a connection to the game and 


testing it by posting the message “Hello 
world” to the screen... 


From mcpi.minecraft import Minecraft 
mc = Minecraft.create() 
mc.postToChat( ) 


If you're entering commands directly into 
the Python window, just hit ENTER after 
each line. If it's a file, save with CTRL+S 
and run with F5. When your code runs, you 


should see your message on screen inside 
the Minecraft game. 


7, lh >) ES * ds] r. *Python 3.4.2 Sheil* al necraft - P) edition 
"i 


1. Find your location 
To find your location, type... 


pos = mc.player.getPos() 


pos now contains your location; access each part of the set of coordinates 
with pos.x, POs.y and pos.z. 


Alternatively, a nice way to get the coordinates into separate variables is to 
use Python's unpacking technique... 


X, VY» Z = mc.player.getPos() 


Now x, y, and z contain each part of your position coordinates. x and z 
are the walking directions (forward/back and left/right) and y Is up/down. 


Note that getPos() returns the location of the player at the time, and if you 
move position you have to call the function again or use the stored location. 


2. Teleport 
‘ne well as finding out your current 
ocation, you can specify a 

particular location to teleport to 


3.Setblock — 
You can place a single block ata 
given set of coordinates with 


mc -setBlock() - 


7 = mc.player.getPos() 


X, Y, Z = mc.player.getPos() X, Yo 
mc.setBlock(xtls Y» 4 


mc.player.setPos(x, y+100, z) 


This will transport your pla 

100 spaces in the air. This will . 
mean you'll teleport to the middle 
of the sky and fall straight back 
down to where you started. 


Now a Stone block should appeal 
beside where youre standing. If 
it’s not ‘mmediately in front of you 
it may be beside or behind you. 
Return to the Minecraft window 
and use the mouse to spin around 
on the spot until you see a grey 
block directly in front of you- 


Try teleporting to somewhere else! 


\ 


Done 


7 
4 


Minecraft’ 


The arguments passed to set.Block are xX, Y, 4 and id. The 
(x, Yy Z) refers to the position in the world (we specified one block away 


from where the player is standing with x+1 ) and the id refers to the type of 
block we'd like to place. 1 is Stone. 


Other blocks you can try... nO 


Air: 

Grass: 

Dirt: 

Now with the block in sight, try 
changing it to something else... 


mc.setBlock(xt!, Ys 4s ) 


You should see the grey Stone 
block change in front of your eyes! 


- Block constants 

prey a block constants to set 
Ss, If you Know their nam 

| es. ; 

need another import line first, nine ge 


5. Block as variable 


If you know the ID of a block, 


it can be useful to set it as 
a variable. You can use the 
name or the integer ID. 


From mcpi import block 


Now you can wri 
it . 
a block... e the following to place 


dirt = 


mc.setBlock(x+3, y, z, block.STONE.id) 
mc.SetBLock(x, 


Y, Zs dirt) 


Block IDs are 
pretty easy to gues 
just use ALL CAPS, but cane “an 


examples to get yo 
ins ania get you used to the way they 


or 


Gules block.DIRT.id 
mc.SsetBLock(x; Yy Zs 


dirt) 


WOOD_PLANKS 


WATER_STATIONARY 

— \__ 
GOLD_ORE fa 
GOLD_BLOCK | - 
DIAMOND_BLOCK @ ty 
NETHER_REACTOR_CORE 4m\® 
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6. Special blocks 
There are some blocks that have extra properties, such as Wool which 


has an extra setting where you can specify the colour. To set this use the 
optional fourth parameter in set.Block ... 


wool = 
mc.setBlock(x, y, z, wool, ) 


Here the fourth parameter 1 sets the Wool colour to orange. Without the 


fourth parameter it is set to the default (@) which is white. Some other 
colours are... 


2: Magenta 
3: Light Blue 
4: Yellow 


Try some more numbers and watch the block change colour! 


Other blocks that have extra properties are wood (17): oak, spruce, birch, 


etc; tall grass ( 31): shrub, grass, fern; torch (50): pointing east, west, Y 
north, south; and more. Soon 


7. Set multiple blocks 


As well as setting a single block with ——*y can 
fll in a volume of space in one go with set.B1Ocks ... 


stone = 
xX, yy Z = mc.player.getPos() ; 
mc.setBlocks(x+l, ytl, Ztl, Xtit, Ytits 


z+i1, stone) 


This will fill ina 10 x 10 x 10 cube of solid Stone. 


You can use 
the set.Blocks 
function to create 
bigger volumes, but 
it may take longer 
to generate! 


one 
B 
~¢ > / 
%, me 


Minecraft’ 


3. Playing with TNT blocks 


Another interesting block is TNT! To place a normal TNT block, use... 


tnt = 
mc.setBlock(x, y, z, tnt) 


However, this TNT block is fairly 
boring. Try applying data as 1... 


tnt = 
mc.setBlock(x, y, Z, tnt, 1) 


Now use your Sword and left 
click the TNT block: it will be 
activated and will explode ina 
matter of seconds! 


Try making a big cube of TNT blocks! 


tnt = 
mc.setBlocks(x+l, ytl, Z+l, xtil, yrll, 2+ 


Now you'll see a big cube 
full of TNT blocks. Go and 
activate one of the blocks 
and then run away to watch 
the show! It'll be really 
slow to render the graphics 
as so many things are 
changing at once. 


Fun with flowing lava 


| One block that’s 
eins tee a lot of fun to play with is 


from mcpi.mine 

cpl. craft import Mi 
mc = Teeaeel aie — 
X, Y, Z = mc. 
—- . player.getPos() 
mc.setBlock(x+3, y+3, z, lava) 


Find the block you've j 

Just placed, 
should see Lava flowing from the he = 
the ground. ock to 


= § 


What next? 
you can do now you 

d the Minecraft i 
Python interface. 


There's plenty 


Oy 
,/ 
Vr Y 
know your way aroun 


world and how to use the 


on one thing — Lava is that when 
own it becomes rock. M 
Ite . Move to 
another location in your world and try this 


from mcpi.mi 
1.minecraft im ® Networked game 
port Minecraft lf multiple people connect Raspberry Pis 


from time i 
e im 
port Sleep to a local network, they can join the same 
Minecraft world and play together. Players 


can see each other in the Minecraft world. 


mc = Minecraft.create() 


© API reference 
For amore extensive documentation of 


X, Ys Z = me.pl 
-_player.getPos() 
functions and a full list of block IDs, visit 
bit.ly/MinecraftAPI 


lava = 

water = 

air = @ Make a game 
Try out another resource and make a Whac- 
a-mole game: Minecraft Whac-a-Block. 


Find links to these projects and more at... 


mc.setBlo 
www.raspberrypl!-org 


Sleep(22) 

mc.setBlock(x+ 

— (X+3,y+5, Z, water) 
mc.setBlock(x+3, y+5, z, air) 


YOU CAN 
ADJUST THE SLEEP 
PARAMETERS TO 
ALLOW MORE OPV 
LESS LAVA 


40 


There are 12 differences be 
Raspberry Pi gang in space. 
differences you find on pictur 
e to jump to page 78 to see if you got 


Set a stopwatch, 


tim it right! 
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tween these two pictures of the 
then mark all the 


e 2 and write in your time. And then it's 


Did you kn 

Ow there 

Piso > are two Ras 

ear nthe International Space sated 
n more at astro-pi.org! ation? 


Puzzles 
IN SPACE 


NO-ONE CAN 
HEAR YOU 


The Result! 


How quickly did you 
Manage to solve the 
puzzle? Write in your 
time below... 


Find the 
answers on page 


78 


a 
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sus 


ce Invaders clone: 


It’s much 
a 
Download the project more rewarding 
! to Wri 
Go to goo.gl/PyzcFA, press the green ‘Clone or download Ite the code 
, mownload ZIP yourself! Press the 
link on the right and select Downloa 
menu button, go 
Set up the files to Programming 
and select Thonny. 
Double-click on the downloaded zip file in your Downloads Open a new file ae 
folder and click the ‘Extract files’ icon, then Maes Now Write out the ee 
click through to the bugs folder to find the project. as you see it here. 
When you'r 
e done 
Right-click on bugs.py and open with Thonny or 4 text editor. project folder you 
You'll find the following code listing. Check out the code, then downloaded with 


‘ 
go to the end of the project (page 45) see how to play 't -_py at the end of 
the file name. 


i — - ™~ j - E a3 
> i = & T , y NSN _ fo . > » | — YY W 
oa | | i i a \ “a os 0) le : f / 
( ; | } ; | ww = 1 |  ) } y y z = 
no Ge Sw = FF 
was. =, 
——S “7 _ a ag ff <x _ 


from random import randint as rand 


Let’s set the resolution | 
and name our game 


WIDTH = W = 
HEIGHT = H = 
TITLE = "Babbage vs Bugs” 4 


Poe, 15 ), (-1,9, ), (01,32), (1,9, ), (@,1,32), (-1,8, )] 


F = [lambda x, y : 9%, 
lambda x, y : y<i, 
lambda x, y : y==1, | 
lambda x, y : y>l, : 
lambda x, y : X&l, | 
lambda x, y : (x‘y)&, 
lambda x, y : 


Class Bug(Actor): 
def __init__(s, pos, kind): 
super().__init__("blank", pos) 


S.Kind = kind 
s.life = kind* 
s.time : 


def update(s): 
s.time 
S.x += P[state.pce][e] 
s.y += P[state.pce][1] 


c = s.collidelist(state.beams[0]) 


iT C >= ‘ 
State.beams[@][c].h = 
s.life -- 
if s.life == 0: yes! WE'VE HIT eee on 
State.score += s.kind* B we NEEO TO Re ‘i | 
7 WITH s.life -= ——— 
s.time = Eh 
if rand(2, ) : 
state.beams[i].append(Beam(s.pos, 3)) 
S.image="bug"+("s" if s.time>®@ else Sstr(s.kind))+str(state.pcil>>3&3) 


class Star(Actor): 
def __init_(s): 
super().__init__("star", (rand(@, W-1), rand(®, H-1))) 


S.V = rand(i, 3) 


def update(s): 
S.y -= S.V 


if s.y < Q: 
S.X = rand(0, W-1) 
S.y += H 


Class Beam(Actor): 
def __init__(s, pos, v): 
super().__init__("beam", pos) 


S.V V 
s.N 


def update(s): 
S.Y t= S.V 


Class Player(Actor): 
def __init_(s): 
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super().__init__("blank", (W/2, H-64)) 


> 


s.timed = Th 
s.timel = Whee ue phi eat i 

. u ECK Tor button 
Suite Presses to move Babbage left 


and right, and Collisions 
7 ; to 
If he’s been hit by a bug. me 


def update(s): 
s.timeQ -= 
s.timel -= 


dx = (3 if keyboard.right else @)-(3 if keyboard.left else @) 
S.X = max(32, min(W-32, s.x+dx)) 


c = s.collidelist(state.beams[1]) 
1f c >= © and s.timed < @: 
state.beams[i][c].h = 


s.life -= 
S.timed = 


if keyboard.space and s.timel < 
state.beams[0].append(Beam(s.pos, -5)) 


s.timel = 


S.image = "bab"+("s" if s.life > @ and s.time® > © else str(state. 


pcil>>4&1)) 


class State: 
def init _(s): 
s.bugs = [] 
s.beams = ([], []) 
s.stars = [Star() for s in range(30)] 


© ee 
& 
eS 


oo , 

ee 

s.player = Player() ; 
& 


 & 
‘18 


s.score = 
S.Space = 

. The class State sets 
— up our game, initialising 
| r player, 


r 
things like bugs, © 
and the scoreboard. 


def update(s): 
if len(s.bugs) == 
for y in range(3): 
for x in range(7): 
S.bugs.append(Bug((W/2+x* 


F[min(s.wave, 6)](x, y) else 1)) 
S.pcO@ = 


S.pcl = 
S.wave += 


for a in s.all(): 
a.update() 
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Babbage versus bugs 


[b for b in s.bugs if b.life > 9] 


s.bugs = 
s.beams = ({b for b in s.beams[Q] if b.y > - and not b.h], 
[b for b in s.beams[i] if b.y < Ht and not b.h]) 
s.pcl += 
if s.pci == P[s.pc][ |: 
s.pcO = 2 if s.pcd== else s.pc0+ 
Ss.pcl = 
def all(s): 
return s.stars+s.beams| ]+s.beams[ ]+s.bugs+[s.player] 


def over(s): 
return s.player.life <= © or len(s.bugs) and max([b.y for b in s.bugs]) 


> s.player.y - 
state = State() 


def update(): 
global state 


if state.over(): 
if keyboard.space and not state.space: 


state = State() 
else: 
state.update() 


state.space = keyboard.space 


def draw(): 
screen.clear() 


for a in state.all(): 
a.draw() 


for i in range(state.player.life): 
screen.blit("life", (6+1*32, H- 


)) 


H-3), fontname="consola’, 


screen.draw.text(str(state.score), bottomright=(W-8, 


fontsize=20) 


if state.over(): 


screen.blit("dark", (2, ©) 
screen.draw.text("GAME OVER", center=(W/2, H/ ), fontname="consola’, 


Run the game! 
ies, and then Terminal. 


Press the menu button, select Accessor 
Type: cd Downloads/Annual-2018-master/ bugs. Now type 


pgzrun bugs-Py (or the name you gave your own file). Enjoy! 


fontsize=1022) 


The spaceman's teddy bear has got stuck /\ (gp f antvers cn necell 
in the centre of this space maze. Can you " 
find the correct pathway to rescue him, then 
escape to the space station? We're giving you 
just 2 minutes to do it... ready, teddy, GO! 


How quickly did you ; 
manage to solve the y 


<a \ 
time below... / | 


THERE ARE TWO PTS ABOARD THE 


—— [my INTECNATIONAL SPACEISTAIION 
46 i” HEARN MORE)AT.. 


iE 7 ’ ane) : 
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a | “yp 


ides 
Beginner:s guide 


SB |_| Ha 
deas and inspiratio 
| 


ke 
Fun projects toms 


ct kit reviewed 


The late 


Subscribe 


The official Raspberry Pj Magazine 


JUNIOR P| 
QJECT. 


RBORG, PLIVICE AND OLED BONNET PR itis sas 
{ a +s ape 


nt 


REVIEWED! M@ 
CLEARI ‘ 


3D BODY sca is d 3 7 Pl ZERO W DEVICES 6 
NEW/ Pitg MPO ALED INncing 


THE MONT: = 


GAZINE WRITTEN By AND FOR THE py COMBALia 
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tion 
A you tick! 


an 
eo fin 


| we Which of these is the best 
Raspberry Pi project? 


hat are your Christmas 
A; hoe for your Raspberry Pi? 


detector 
A. Build a Santa | 
B. Teach it to fire darts at your sister 


C. Leave it on the floor in the dark so 
) Dad steps on it in bare feet 


3 


A. An elegant moustache 
B. Terrifying bat wings 


C. A laser turret 
es | Wm You have a terrible 


Raspberry Pj nightmare 
What happened? 


A. Hamster disco 
B. Parent detector 
C. WhooPi Cushion 


| What would make your 
Raspberry Pi even better? 


Your Raspberry iia 
How did it happens 


A. Killer robots 


‘ Automatic homework-giving 
machine 


C. Healthy eating program, with 
lots of vegetables 


ed out of a tree 
nto a school dinner 


A. Plummet 


B. Dropped into 
C. Fell in the toilet 


Personality Test 


* ta 
Aah —*e 
" 


— the 


‘ 


best name f 
Ora 
Raspberry Pj robot? 


A. Alfonse 


B. Mr F luffypants 
C. Murderborg 


You need to hide your 
Raspberry PI from your 
brother. Where do you 


conceal It? 


you most like to 
build with your Pi? 


A. Robo-shark. With lasers. 
B. Robo-dog 
C. Robo-butler 


A. inthe fruit bowl 
B. In your stinky gym kit 
C. In Mum's underwear drawer 


Scores 


Each answer you give earns 
you points! Answer A=1 point, 
B = 2 points and C = 3 points. Flip 
the book over and find out how you 
scored at the bottom of the page’ —— 


‘Auun 

- S110 

A “AyyBbneu j1q & SauNawos pue yt — ‘DZ 

"'J0qOJ B UMO 0} a» ‘andi oe 
2 I] P,NOA, ‘asd 
A, - A\qeqoud p,noX ‘1a}suow Aue aq Seegtars : 

oe eam milnit YIM S}Uasaid Huluado si sewnsi hd he 

EJ ANOA We}s SPLISH Bu11a}31/6 e se ot "EL-9 


joAey NOA Ay 
Oo pU i yyeuosiad id A 
¥© Pub] YEYM INO puy — sioop ay} UO ie poh ney 


hides a special 


This is the Wheel of Pl. and it 
phrase! Skip every other letter to decipher the 
code — you have just tes to crack It! The 
pictures might help you a bit! 


Find the 


50 


How ; 
quickly dj 
m Yy did 

pipers iy solve the 
tim e! Write in ‘ 


a 


THE AGVEN, TURE THAT STARTED A, DIGI HAGREVOEU TION! 


MANY YEARS AGO... 


Together... 


ye 


My friends! 
We have finally completed 
the PCB of destiny. 
Our mission can now begin! 


MUHAHAHAHA! 


With this sacred Pi, 
we can create a world of 
knowledge, peace, joy, and 
delicious code! 


FOOLS! 
THE ONLY WORLD YOU 
SHALL INHABIT IS A WORLD 
OF MISERY AND PAIN! 


SHANA 


HAHA! 


Our vision has 
been realised. 
We really did it! 


= | 
< 


Hell Yeah! 


Every child in 
the world has 
been empowered 
by the wonderous 
might of 
aspberry Fi, 

every- 


The Professor 
sent me. There's some 
kind of life-threatening 

emergency! 


What's the word, 
Professor? 


UFO approaching 
atmosphere, Sir. 


| don't like 
this one bit! 


at -—_ 
Livets =. 
3 : 1 


> sete aw 


INCOMING \ 
COMMUNICATION! J) 


: Greetings, t 
> R IO = 


aspberry goons! 

«I'll keep this brief 
So your puny 

minds can -» 


keep up! 


My name is 
Doctor Bluescreen. 
| am here to upload 
your brainy children 
into a giant 
spreadsheet and 
use their knowledge 
for a variety of 
evil deeds. 


Approaching 
at SPEED! 


Holy GPIO! | must 
Doctor Bluescreen assemble 
really is uploading the Founders 

the children! once again 
to defeat this 
great evil. 


They are 
approaching, 
Doctor. 


Excellent. 
The fools have 


i : There she is! 
flown straight Fe . 
into my 9 - Time to put an end 


sticky-icky web. ie | to this madness. 
Hahahah! | 


Hmmm, 
her shields are 
stronger than 

we thought. 


Haha! 
Your pathetic code 
beams are no match 
for my mighty orb! 


We must merge our 
code into one beam 
of pure energy! 


Argh! Still nothing! 
Her shields are 
resistant to our code! 


Enough of this! Release the 


It's time to fry these 
fools. There is much } Vi RU § 


evil to be done. 


What's... 
happening? | 
can't...move! 


IT'S A TRAP! 


BACK AT THE PI LAB 


It seems they've 
been trapped by 


& > 7 Come in, come in some kind of virus! 
do you read me: 


eA 


ef 


WHAT THE HELL \w 
ARE WE GOING 
T0 00?! 


Pull yourself 
together, man! y 


Now think, 
there must 
be something | needed that. 


we can do. Well, legend 


has it that 


there is an 
ancient computer r 
that can be used 
in times of dire 
need. But that's 
just some legend 
from 1985! f 


= | Do you mean 
The computer ee this old thing? 
could be anywhere ~ rE 
in the world! 
how could we ever 
find it in time 
to save them?! 


Come on, 
let's hack this thing 
back to life and 
save the WORLD! 


Doctor, all the children Excellent! 
are uploaded into Let's destroy 
the spreadsheet those Raspberry 

and saved to | fools and be on 
your desktop. ! our evil way. 


friends... 7 If this is our end, 
| grow week | let it be known that... 
we fought gallantly, 
even if...our efforts 
were futile. 


EUREKA! 


| It's alive! 


i az 


Our shields 
have been disabled! 
The children are 


downloading back 
to earth! 


IMPOSSIBLE! BPs, Let's CODE! 


Mecha-Babbage! 
How can we ever 
repay you? 


See ya, 
Babbage. 
Such a 
nice guy. 


’ Andwhat have ‘“ 
we learned from 
our little 
adventure? 


. £f 
~~ 


y Err..yeah, that \ 
| too! But the main 
| lesson here is 

. that... 


You have freed 
me from my 
watery tomb—I can 
now return to 
my Mecha-family. 
That is thanks enough, § 
my tiny friends. | 


i Well—we did i it. 


The earth is safe 
NS once again! d 


That all life is a precious 
and delicate gift that must 


be nurtured and loved like a flower? 


PBERRY Py 
Gy Rue ES! , 


BNI 


Python Project 


r first | | 
: : il take you * By making patterns with Python 
In this project yrogrammind language code, you will learn... 
; I 
steps with the P hapes patterns, and , 
hon to draw shapes, len amed @ To take your first steps with the 
Pyt You will use a modu Python programming language 
spirals. ° you will learn ® How to draw lines with Python Turtle 
Turtle. Along the noes ces and use @ How to make turns 
a = ) e 
how to think 1n seq uence. This 1S @ How to change the pen colour 
loops to repeat a sed oma visual @ How to use loops to repeat some 


i d create shapes 
t ste : tch to instructions an 
a grea nt language like Scra eos @ How to use more loops to create 
program d environment of Py a | impressive spiral patterns 


the text-base 


LEARN HOW 
TO CONTROL ME 
USING EASY 
PYTHON CODE! _ 
“* 


y 

fs - 
? (iif ; = i = ca é- 
we £ if? : 4 ay, AEy ; c a 


Note — 
Make sure you don’t call 


your Turtle projects turtle 3 
- that’s the name of the Pylon” 
library you're importing! 


> EH He 
@ Tick off each 
| step as you go! 


te ta 
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eo Is it art, maths, or 
computer science? 


Have a look at the image to the right. 
How would you describe it? Is Is art, 
maths, or computer science? 


It's a computer-generated image, but 
making it requires an understanding 
of art, maths, and computer science. 
Let’s see how you too can make 
images just like this. 


2 Drawing aline 


The image above ‘s made up of lines and 
only lines! To get started, you need ‘0 a 
know how to draw a line using a little DI 

of Python code. Below !s some code we 
would like you to write into Python — see 
the note box for options for experimenting 
with Python. Type ‘1 the code and then 
Run it to see what happens. 


from turtle import Turtle, Screen 


Turtle() 
Screen() 


turtle 
screen 


turtle.forward(10°) 


1. Click on Run to see the code working. 


I ber in the 
2. Now try changing the numD® 
line turtle.forward(1e®) ‘click on 
Run again and see what happens. 


Note 


You can run Python code 


in a browser usj ] 

| ? Ng online 
mies like Trinket (trinket io) 
Oad up Python on bey 


Pl. You will find hice Raspberry 


latest versi 
Inthe Programming meny ersions 


Python Project 


Turning 


You've used code to draw a line. Good work! Now let's try making 
the turtle turn around. To do this you need to instruct the turtle not 
only to move forward, but also to turn right or left. 


from turtle import Turtle, Screen 


turtle = Turtle() 
screen = Screen() 


turtle.forward(i90) 
turtle.right(90) 
turtle.forward(10@) 


1. What do you think will happen in the 
code above? Click on Run to see if you were right. 


turtle.right(9@) turns the cursor 90 degrees right. You can also 
turn left with turtle. left(92) . To change the amount that the 
cursor turns, simply change the value of degrees. 


2. Complete the Square shape you've started by adding more lines 
of code and press Run. Keep trying until you get it right. 


\i 9 


Done 


Challenge 


Try to complete each of the 
challenges below... 


© Draw arectangle: two of the four 


sides need to be longer 
@ Draw a triangle: how many 


ad - 4 $ é & oa, . : ’ 
df 7 af | 1 \ 1 
| ? | | degrees do you need to turn? 
| —_) @ Draw a cross: backward and 
| Z forward work well together . 
( A @ Draw a circle: what happens if 
| ff you turn lots? 
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Turtiey Amazing 


Aa. Changing colours 


The default colour for the pen used by 
the turtle cursor is black, and the default 


4. You can change the 
colour of the turtle as 
well. Run the code below 


background colour is white. You can to see wh 

ath 
change the colours to make your shapes nn 
look even better. from turtle import 


Turtle, Screen 
1. Look at the code below. It contains 


three variables called R, G, and B. turtle = Turtle() 

screen = Screen() 

from turtle import Turtle, Screen screen.colormode(255) 
R = 

turtle = Turtle() Shs 

screen = Screen() on 

screen.colormode(255) 

R - turtle.color((R, G, B)) 

— turtle.forward( ) 

— turtle.right(120) 


turtle.forward( ) 
screen.bgcolor((R, G; B)) 


\ 
& Done $ 
Variables are a way of storing a value A a 7 
and giving it a name. For instance, there a = 
is a variable name R with a value of | 


233)- 


2. Run the code and see what happens. 


3. Try changing the values of the three 


variables, and see what happens. Ch 

(Note: the maximum value is 259, Try to allenge 

and after this there will be no effect.) challenges here each of the 
W. 


What do you think R, G, and B 


@ 
represent? You can change the value Complete the tri 


angl ; 
a colour of your gle above with 


of your variables either by setting © Draw a sqy choice 
them to a new value, or by increasing are four Fa ere which 
ades of red 


and decreasing them. © Draw a cross made of 
different colours of four 
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1. Here, wef 
A d ave used a whi 
— rg This ee mar 
a — Inside the loop (i.e 
aa which is indented | 
oat Peat forever. Yoy 
ry to see what it does 


but r 
e€membe . 

ritw 
around forever! ill loop 


B+ repetition 


code Is one of the 


Repeating lines of 
fastest ways to get something done. Quite 


often in computer science, it makes more 

sense to repeat lines of code rather than 

write out another set of instructions. For 
example, the square you created earlier 
uses the same two instructions four 
times. Rather than writing them out four 
times, you could write them out once but 
add an instruction to repeat them. 


from 


tur 
Screen tle import Turtle 


turtle = Turtle() 


while True: 


turtle.forward(1) 


wo types of loops 
turtle.right/ ) 


In Python there are t 
that you are likely to use: a while loop and 


4 for loop. If you want a section of code to 
repeat forever, OF until a condition is set, 
then a while loop might be best. If you 
want to loop for a set number of times, 


then a for loop Is preferable. 


This ty 

Pe of loop j 
to P Is not goj 
masa useful for Pia 
vee 7 with Turtle where i 


A for loop repeats instructions 


2. In thi 
- S example, 
4 set number of times, in this 


a for loop 
a beenused. || 2 1 2 3 * 5607 Pr case 8 times. A for loop has 
Hi phn to see an associated variable (called 
at happens. ll 4 here). In this example, 1 
. & Done @ starts from @ and increases by 
A Pon turtle | s 4 each time. Let's apply this to 
zs port Turtle, S : the code to draw a square... 
creen a 
tu z from turtle import 
rtle = Turtle() Turtle, Screen 
turtle = Turtle 
turtle.penup() 0 
for i in range( ): 
Ole 
1 in range(8): turtle.forward(10°) 
turtle.right(2®) 


turtle.write(i) 
turtle.forward 
oi &* Done 


\i » 
] —_ 
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3. “ the code in step 2, the turtle has 
en asked to repeat two instructions 
our times to make a square. 


4. Once you have created one shape 
using a loop, you can repeat the shape 
again and again by putting it inside 
another loop. This is a great way to 
draw spirals. Adapt your code b 
making it look like this... , 


From turtle import Turtle, Screen 
turtle = Turtle() 


for i in range(3e): 
for i in range(4): 
turtle.forward(102) 
turtle.right(90) 
turtle.right(25) 


; Spiral can be made by turning a small 
egree and then moving forward a small 
amount. The section of code for makin 

a square is Inside another for loop i 
repeats it 30 times, each time turning th 
cursor 25 degrees to make a pleasi a 
spiral shape. 7 


Qn 
K 
\ 


N 


6 Cink 


© Lear 


® Create interactive stories 


Chalienge 


Try to complete each of the 
challenges below... 


@ Can you alter the for loop so 
that it draws a more interesting 
spiral using one of the shapes 
you made earlier, like a triangle 
or circle? 

@ Adding a few extra lines where 
you alter the variables R, G, 
and 'B would allow you to make 
a multicoloured spiral. Have a 
go at creating a rainbow spiral. 

@ Draw a circle: what happens 
if you turn lots? 


~~ \ 


\ 


— fs 
: } 4/7 a : 

=~ Fs ee fie SeQELD 
hings to try--: 


the 


Take your Raspberry PI tricks to 
next level with these ideas! 


n how to use functions to draw 
snowflakes using Turtle 
using lists 


in Python with the Storytime resource 


found on the Raspberry Pi we 
our first steps controlling physical 
with Python and a Raspberry Pl 
ert by 

d tutorial 


bsite 


® Take y 
objects 
® Become a Python turtle exp 
continuing with the advance 


of Turtley Amazing: 


Visit... 
www.raspberryp!-org 


7O 


Python Project 


hoc 


In the bad old days before 
TV and computers, the 
most popular family 
entertainment was the 
whoopee cushion, a tooty 
balloon made from an 
unwashed pigs bladder. 
This was inflated and 
hidden under grandad's 
chair cushion — when 

he sat down it ‘PARPED! 
loudly, making him jump 
into the alt and his false 
teeth fly out. It was 

the best thing ever 
(especially when 

the dog caught the 

teeth and ran about 
wearing them and. 
grinning). This project 
brings the whoopee 
cushion up to date: no 
bladder; no need to 

blow it up; and 

you cana 

whatever 

noises 

you want! 


sg 
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What you will need 


) To build your very own farting 
machine you are going to need... 


@ 2 paper plates 

@ A washing-up sponge 
@ Kitchen foil 

@ Sticky tape 


@ Glue or double-sided tape 

@ 2 female header wires (that fit on the 
| GPIO pins) 

1 @2 lengths of thin, insulated wire 

@ Aspeaker (the louder the better!) 


HEE-HEE! 
EVERYONE WILL 


THINK GRANDA 
D 
HAS FARTED! 


pa 
g | 


®@ How to 
create Raspb i 
with household orion —— 


@ How to 

code si 

mple programs j 
ython to carry out eee 


@H 
Ow to use the Terminal 


The WhoopPi Cushion 
A: Making the WhooP! Cus 


1. Tape or stick squares of foil on the middle of the “eating” side of each 
plate. These are your contacts — when they touch, they'll make a circuit. 

2. Strip the end of one of the long wires and tape it to one of the squares of 
foil. Make sure it makes good contact with the foil. Do the same with the 
other wire and the other plate. 

3. Chop the sponge up into cube chunks and glue them around the foil on 

one of the plates — this will stop the foil squares touching each other until 

someone sits on the plate. It should look something like this... 


4. Put the two plates together so that foil squares 
are on the inside and facing each other. Tape 
them together. 


5. You now have a ‘cushion’ made of two plates with 
two connecting wires coming out. Later we will 
connect these wires to the GPIO pins on your 
Raspberry Pi: one to a ground pin and the other 
to a pin that we will use to detect when the circuit 

‘s made. For this we will use the header wires. 


Python Project 


6. Strip the ends of the 
connecting wires and attach 
each one to a female header 
lead. One way is to cut off one 
end of the header lead, strip It, 
twist it to the long connecting 
wire, and then insulate the join 
with tape — but do whatever 
works best for you. 


It's now time to hook up the Pi to 
your finished WhooP! cushion! 


2. Connect the WhooP? 
Cushion to the Pi 


Note that if you 
have an older 
Raspberry Pi 
model you'll only 
have 26 pins, but 
they have the 
same layout. 


1. Plug one 
header lead (it 
doesn't matter 
which) onto a 
ground (GND) 
pin on the Pi... 
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her wire into GPIO pin 2... 


2. Plug the o! That's the hardware complete, now 


for the Software! We are 


You will be usin 
g the com : 
to type stuff in To do th; mand line 


You can 
damage 
your Raspberry 
P1 if you do not 
use the GPIO pins 
correctly. Stay away 
from the 5V pins! 


WARNING! 


3. Test the sound 


1. Connect the speaker to the 
Raspberry PI. 


4. Download the burp sample with the 
following command... 
wget http://rpf.io/burp -0 
burp.wave 


This will download the sample into the 
whoopee folder and rename it to burp.wav 


5. Now test that you can play the sound 
file using omxplayer by typing... 
omxplayer burp.wav 


2. Create a new folder called 
whoopee with the following 
command... 

mkdir whoopee 


You should hear it from the speakers 
or headphones connected to your 
Raspberry Pi. alll 


3. Enter the folder with... 
cd whoopee 


We're going to need a sample | 
sound file for this project, so we'll 
download one. 


Python Project 


If you can’t hear anything, make sure that 
your speakers are connected correctly. If 
this still doesn’t work, you'll need to change 
your audio configuration. To switch audio to 
the headphone jack, return to the Terminal 


window and type the following command... 
amixer cset numid=3 1 


Then try running the omxplayer burp.wav 
command again. Once the sound is working, 
It's time to write the program itself. 


ae Write the 


d to 
1. To write your Python program you amen 
| Python programm | 
ope ae command line. To do this type 
the following command... 
sudo idle3 & 


4. Save the file by clicking on 
File and Save. 


5. Run the program by 
clicking on Run and Run 
Module (shortcut: F5) 


2. Once IDLE3 has opened, click ' img 
| New Window. This will open ab = oe 
Click on File and Save As and nam 


file whoopee.Ppy- 


6. Finally, test your program 
- check that the sample 
plays when the foil 
contacts are gently pushed 
together. If it's all working 
then it's ready to go! 


isely. 
ogram precise 
e in the following prog 
” pe special attention to ola and 
lower-case/upper-case letters!) 
import time 
import Rpi.GPIO as GPIO 
import Os 


GP10.setmode(GP1O.BCM) 
GPIO.setup( ,GP1O. IN) 
while True: — 
-£ GPIO.input(?2) == ; 
- os.system(“omxplayer burp.wav'" ) 
time.sleep(2->) 
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® Carefully place your WhooP! 


® The tricky bit is setting up the 


@ Hide it, run the program, and wait. 


RASPBERRY PI 
PROVECT IS SO : 
MUCH FUN! we 


5. Setting it up 


Cushion where your victim will sit 
on it (obviously!), but not under a 
really heavy cushion where it will 
squash it straight away. 


Hint 


Whistle tunelessly and 
look around at the ceiling. 
This will make you look 
innocent and attract 

Pi so that it can't be seen — potential victims. 
remember, you'll need a plug 
socket unless you are using a 


battery for your Pi. 


Take your Ras 


Next level with | tricks to the 


these ideas! 


© Use other no; 
rnois 
need to be in es/tunes/samples. They 


at 


Visit... 
www.raspberrypi.org/resources/make/ 


for more ideas and for help on using 
buttons and input devices on the PI. 
This is also the first place to go if you 
are stuck or somethings not working. 
You can also ask questions and get 
help on our forums at... 


Timed Chal 


na 
rk out these a 
ranean +10 minutes to 


grams? 


ane u out 
shaded green column may help yo 


ENACT FIRM 
RENT MAIL 
TSK DOPE 
RAG ROMP 
DO BAKERY 
ERRS BOW 
SLEW RISE 
WOK TERN 
NOT HYP 
BRIAN SPA 
NIL UX 


ZZZAP! T’'VE 
SCRAMBLED ALL 
THE WORDS WITH 
MY RAYEUN! 


How quickly dj 
y did you 
Manage to solve the 


| € iN your 
time below.. y 


ndt 
answers on page 
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def test1 (): ; 
texti = "apple 
print(text1) 


def test2 (): : 
text1 = "eniregnat 


text2 = "" 
for x in range (len (text1)): 


aye) cis geal yo 
print(text2) 


def test3 (): 


text1l = oag 
text2 = "ren” 
text3 = "" 


for x in range (len (text1)): 
text3 += text1[x] 
text3 += text2[-1 * x] 


print(text3) 


def test4 (): 
text1 = "bceyabrikr” 
Tex 
x = 0 
for y in range (len (text1)): 
text2 += text1[x] 


X += / 
x %= len (text1) 


print(text2) 


def test5 (): 
listi = [109, 97, 110, 103, 111] 


text1 = "" 
for x in range (len (list1)): 
text1 += chr (list1[x]) 


print(text1) 


Learn to code 
with Python, 
visit... 


www.raspberrypi.org/ 


learning/python-intro 


How good is your Python — and your codebreaking? Here's a challenge to find out. There 
are 8 Python functions — each of them prints out a single word when run. Can you work out 
what all 8 words are, and what they have in common? If you get really stuck, you can use 
Python on your Pi to run them, but try to work it out without cheating first! 


THE FIRST ONE 
IS REALLY EASY, 


TO GET YOU 
STARTED! 
a, 
aus Je 


def test6 (): 


text1 = "dsulfrw" 
text2 oun 


~ in range (len (text1)): 
ext2 += chr (ord (text1[x]) - 3) 


print(text2) 


def test7 (): 


Cextl = "($+1$7,4" 
text? _ oun 


for x in range (len ( 
text1)): 
text2 += chr (ord (text1[x]) * 69) 


print(text2) 


def test8 (): 


list1 = [0,39,16,10 
27,30,17,34,0,35,41,19,24,40,13,0,19] 


text oun 


a = int (pow (len (list1), 9 
» 8.5 
for x in range (1 + max rere [i ay: 


Z = sum (list1) // 
for y in range (a): 


If y+x* ai 
Zt= 1 « 
text1 += chr (z) 


print(text1) 


a 


n list1: 
(a@- 1- y) 


Puzzle Answers rN a , »- ~~ 


Did you manage to find the 12 differences in 12 more tricky differences here... 
the board? 


i pl 


hry en 
s 


How fast did you managed to find the 17 
hidden words? 


The phrase was: CODE MINECRAFT WITH PI 


The answers were: Minecraft, Terminal, 
Desktop, Program, Keyboard, Browser, 
Wireless, Network, Python, Raspbian, Linux. 
The secret phrase was Raspberry Pi. 


Answers: apple, tangerine, orange, blackberry, 
mango, apricot, mandarin, raspberry. 
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qaspberr 


ANNUAL 


GET STARTED 


Set-up your Raspberry Pi & use it for the first time 


SOLVE PUZZLES 


Spot the difference, word searches, mazes & more! 


MAKE PROJECTS 


WhoopPi cushion, Santa detector & tree lights 


LEARN TO CODE 


Learn as you go with Scratch & Python projects ; 


HACK MINECRAFT 


Code with Minecraft on your Raspberry Pi 


WRITE A GAME 


Create your own version of Space Invaders! 
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